---
title: "08-PRD- AI 角色化研发工作流 Web 平台"
created: 2026-05-08
tags:
  - 项目
aliases:
  - PRD- AI 角色化研发工作流 Web 平台
---

# PRD: AI 角色化研发工作流 Web 平台

> 版本：v0.1 ｜ 创建日期：2026-05-08 ｜ 状态：已确认

## 1. 背景与目标

- **业务背景**：个人开发者在使用 AI 辅助编程时，常因全盘依赖单一模型导致逻辑跑偏、陷入反复修正的泥潭。真实的软件开发需要分层决策与文档约束，但个人开发者缺乏模拟这一过程的工具。
- **核心目标**：
  1. 提供一个轻量级 Web 平台，将研发流程固化为“产品-架构-研发-QA” 4 个文档流转节点。
  2. 通过“强节点确认”和“结构化上下文传递”，降低 AI 编码时的理解偏差。
  3. 实现纯浏览器端的本地化运行，零后端存储，保障用户 API 隐私。
- **非目标 / 不做项**：本期不包含任何服务器端的用户账号体系与云端数据同步；不内置大模型计费/代付系统；不开放系统级提示词（Prompt）的修改权限；不包含最终的代码生成执行环境（仅产出 Markdown 文件）。

## 2. 用户与场景

- **目标用户**：习惯使用 Cursor、Claude Code 等 AI 编程工具的个人开发者或 1~3 人微型创业团队。
- **核心场景**：在获得一个新的软件 Idea，或者准备开发一个复杂功能模块前，用户打开本平台，通过对话将模糊的想法转化为严谨的工程执行文档，然后再去 IDE 中写代码。
- **痛点**：缺乏前期设计导致后续代码重构成本极高；手写需求和架构文档过于耗时。

## 3. 用户故事（Given-When-Then 格式）

- **US-001 [模型配置]**：作为开发者，当我首次使用平台时，我希望能够为 4 个不同的角色分别配置 API Key 和对应的模型型号，以便我可以根据任务难度分配不同智力水平的模型（如选优选大模型做架构，便宜模型做 QA）。
- **US-002 [节点生成与确认]**：作为开发者，当我在节点 1（产品对齐师）输入需求后，我希望系统生成文档后暂停，以便我能在界面上审核、修改该文档，确认无误后再点击推进到下一个节点。
- **US-003 [单点回滚与手动更新]**：作为开发者，当流程走到节点 3 时我发现需求有遗漏，我希望退回节点 1 修改 PRD。当我确认修改后，我希望下游节点（节点 2、3）变为“已失效”状态，以便我可以手动依次点击重新生成它们。
- **US-004 [局部重试]**：作为开发者，当 API 调用由于网络或 Token 限制中断时，我希望看到明确的报错，并保留已经生成的一半文字，以便我可以点击“重试”继续生成，而不是全部重来。
- **US-005 [产物导出]**：作为开发者，当所有流程结束时，我希望在左侧看到完整的文件树，并在右侧预览内容，以便我可以手动逐个复制 Markdown 文件内容到我的本地开发工具中。

## 4. 功能清单

| **编号** | **功能名** | **描述** | **优先级** | **关联用户故事** |
| --- | --- | --- | --- | --- |
| F-001 | 全局设置面板 | 支持为 4 个 Gem 独立设置 API URL、Key、Model Name。数据仅存入 LocalStorage。 | P0 | US-001 |
| F-002 | 工作流流转引擎 | 实现四个节点的线性状态机（生成中、待确认、已确认、已失效），控制上下文文件的精准投喂。 | P0 | US-002 |
| F-003 | 富文本/Markdown 编辑器 | 节点暂停时，允许用户直接在网页上编辑 AI 生成的产物内容。 | P0 | US-002 |
| F-004 | 节点作废与重跑机制 | 上游节点被修改并重新确认后，自动将依赖其产物的所有下游节点状态置为“已失效/需更新”，并暴露重新生成按钮。 | P0 | US-003 |
| F-005 | 极简异常处理 | 捕获 API 超时或报错，中止流转，红字提示并提供重试按钮，保留流中已接收的文本。 | P1 | US-004 |
| F-006 | 产物预览与复制面板 | 左侧展示生成的 `PRD.md`, `DESIGN.md`, `TASKS.md` 等列表，右侧展示详情与“一键复制”按钮。 | P0 | US-005 |

## 5. 非功能需求

- **性能**：首屏加载时间 < 2秒。
- **可用性**：所有用户输入和流转状态必须实时持久化到浏览器的 LocalStorage 或 IndexedDB，防止意外刷新导致数据丢失。
- **安全与权限**：API Key 必须以明文/简单加密形式仅存在本地，绝对禁止任何形式的网络上报行为。

## 6. 边界与异常

- **空状态**：用户未配置 API Key 直接点击生成时，阻断操作并弹出全局设置面板。
- **失败处理**：LLM 吐出的数据如果不符合 Markdown 规范，系统不强制校验，按原样渲染，交由用户在“确认环节”手动修正。
- **浏览器存储超限**：如 IndexedDB 满载（极罕见），提示用户清理历史会话。

## 7. 依赖与集成

- **依赖的已有系统/服务**：依赖用户自行提供的 OpenAI/Anthropic/Google 等兼容 API。
- **第三方账号/API**：无。

## 8. 验收标准

- AC-001：用户能在断网刷新页面后，依然看到上一次填写的 API Key 和进行到一半的工作流状态。
- AC-002：修改节点 1 后，节点 2、3、4 的 UI 会出现明确的“视觉警告（如变灰或红点）”，提示用户上下文已过期。
- AC-003：用户可以成功复制最终生成的任意 Markdown 文件，且格式与标准 Markdown 语法完全一致。

---

# FLOW: AI 角色化研发工作流 Web 平台

## 主路径

### 主流程 M1：标准的四步流转与产出

1. 用户进入 Web 页面，首次访问触发侧边栏 [全局设置面板]。
2. 用户配置 4 个阶段的 API Key 与模型，点击保存。
3. 系统展示主工作区，状态处于 [节点1：产品对齐 - 等待输入]。
4. 用户在输入框提供白话需求，点击“开始对齐”。
5. 系统调用配置好的 API，流式输出 `PRD.md` 和 `FLOW.md`。
6. 生成完毕，节点 1 状态变为 [待确认]，出现“修改”和“确认并进入下一节点”按钮。
7. 用户点击“确认”，系统进入 [节点2：架构设计]，将节点 1 的产物作为上下文不可见地投喂给节点 2 的 API。
8. 节点 2 生成 `DESIGN.md`，暂停等待确认。
9. 用户依次完成节点 3（生成 `TASKS.md`）和节点 4（生成 `ACCEPTANCE.md`）的确认。
10. 系统进入 [终态：完成区]，左侧展示文件树，右侧展示选中的文件内容与复制按钮。
11. 用户挨个点击复制，流程结束。

## 异常路径

### 异常 E1：API 调用异常（网络/Token不足）

- **触发条件**：在任意节点的生成过程中，API 接口返回非 200 状态码，或请求超时。
- **系统行为**：立即停止流式输出渲染。在当前生成区域的底部抛出红色错误提示框（显示原生报错信息）。保留已经生成的残缺文本。
- **用户可执行操作**：用户点击错误框旁边的“重试”按钮，系统清空残缺文本，使用相同的上下文重新发起 API 请求。

### 异常 E2：中途返回修改（单点回滚）

- **触发条件**：当前工作流已经推进到节点 3 或之后，用户主动点击节点 1（产品）或节点 2（架构）的“返回编辑”按钮。
- **系统行为**：系统将目标节点（如节点 1）的状态改回 [编辑中]。
- **用户可执行操作**：用户修改 `PRD.md` 的文本，并点击“保存并确认”。
- **系统行为**：系统将节点 2、3、4 的状态全部标记为 [已失效/需更新]（UI 标黄或显示警告图标），并禁用总产物区的复制功能。
- **用户可执行操作**：用户必须回到节点 2 的 UI 面板，点击“重新生成”，以此类推手动推进。

## 状态变化

- **单节点状态机**：`等待输入` → `生成中` → `待确认`（此时可编辑） → `已确认`（传导给下一节点） → `已失效`（当上游变更时触发）。
- **全局会话状态机**：`配置校验` → `流转中` → `全量完成`。

---

**VibeCoding 导航**：⬅️ [[07-辅助工具|辅助工具]] | 🏠 [[00-VibeCoding|00-VibeCoding]] | ➡️ [[09-AI辅助编程现状分析|09-AI辅助编程现状分析]]